Add a note that cairo contexts cannot be cached for handling expose

        * gdk/gdkcairo.c (gdk_cairo_create): Add a note that cairo
        contexts cannot be cached for handling expose events.
        Proposed by Behdad Esfahbod.

svn path=/trunk/; revision=20800

diff --git a/ChangeLog b/ChangeLog
index 303157d3669439e311ec28eb06cb4c4b8cffed63..8bceb019e84d5bef1c19bfe449a8ae0bfc3d5b3d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2008-07-06  Matthias Clasen  <mclasen@redhat.com>
+
+       Bug 469068 – clarify gdk_cairo_create()
+
+       * gdk/gdkcairo.c (gdk_cairo_create): Add a note that cairo
+       contexts cannot be cached for handling expose events.
+       Proposed by Behdad Esfahbod.
+
 2008-07-06  Matthias Clasen  <mclasen@redhat.com>
 
        Bug 507953 – gtk_tree_view_set_tooltip_column() shows markups

diff --git a/gdk/gdkcairo.c b/gdk/gdkcairo.c
index 4c2d91ac0beee3ffaf97fd97c1e38c90491d335d..6e83f53a375f30c8786fc59cbbc67077cf104cb3 100644 (file)
--- a/gdk/gdkcairo.c
+++ b/gdk/gdkcairo.c
@@ -29,6 +29,12 @@
  * 
  * Creates a Cairo context for drawing to @drawable.
  *
+ * <note><para>
+ * Note that due to double-buffering, Cairo contexts created 
+ * in a GTK+ expose event handler cannot be cached and reused 
+ * between different expose events. 
+ * </para></note>
+ *
  * Return value: A newly created Cairo context. Free with
  *  cairo_destroy() when you are done drawing.
  *